<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
<HTML><HEAD>
<TITLE>IBM Visualization Data Explorer Programmer&#39;s Reference</TITLE>

<META HTTP-EQUIV="abstract" CONTENT="IBM Visualization Data Explorer
Programmer&#39;s Reference">
<META HTTP-EQUIV="contact" CONTENT="IBM Visualization Data Explorer
(ibmdx@watson.ibm.com)">
<META HTTP-EQUIV="owner" CONTENT="IBM Visualization Data Explorer
(ibmdx@watson.ibm.com)">
<META HTTP-EQUIV="updated" CONTENT="Tue, 16 Sep 1997 ">
<META HTTP-EQUIV="review" CONTENT="Fri, 14 Aug 1998 ">

<META HTTP-EQUIV="keywords" CONTENT="GRAPHICS VISUALIZATION VISUAL PROGRAM DATA
MINING">
<meta http-equiv="content-type" content="text/html;charset=ISO-8859-1">
</HEAD><BODY BGCOLOR="#FFFFFF">

<A NAME="Top_Of_Page"></A>
<H1>IBM Visualization Data Explorer Programmer&#39;s Reference</H1>
<B>&#91; <A HREF="#Bot_Of_Page">Bottom of Page</A> &#124; <A
HREF="progu295.htm">Previous Page</A> &#124; <A HREF="progu297.htm">Next
Page</A> &#124; <A HREF="../proguide.htm#ToC">Table of Contents</A> &#124; <A
HREF="progu097.htm#PToC20">Partial Table of Contents</A> &#124; <A
HREF="progu344.htm#HDRINDEX_START">Index</A> &#93;</B><HR><P>
<H3><A NAME="HDRDXRIB" HREF="progu097.htm#PToC_390">DXRibbon</A></H3>
<A NAME="IDX2018"></A>
<A NAME="IDX2019"></A>
<P><STRONG>Function</STRONG>
<P>Produces a ribbon of the given width from a path or group of paths.
<P><STRONG>Syntax</STRONG>
<BR>
<TT><STRONG><BR>
&#35;include &lt;dx/dx.h&gt;<BR>
<P><BR>
Object DXRibbon(Object o, double width)<BR>
</STRONG></TT><BR>
<P><STRONG>Functional Details</STRONG>
<P>Produces a ribbon of the width
<TT><STRONG>
width
</STRONG></TT>
from a path or group of paths in Object
<TT><STRONG>o</STRONG></TT>.  The
ribbon is perpendicular to the normal and parallel to the tangent
at each point on the path, where the normals are provided
by the
&quot;normals&quot;
component if present or approximated
from the path otherwise.  The normals (given or computed) are
translated to the generated vertices and associated with the ribbon
for shading.  If
the direction of the normals changes too rapidly, breaks in
the ribbon
may occur.
<P>For additional details on ribbons, see Ribbon in
<I>IBM Visualization Data Explorer User&#39;s Reference</I>.
<P><STRONG>Return Value</STRONG>
<P>Returns the ribbon, or returns
<TT><STRONG>
NULL
</STRONG></TT>
and sets the error
code to indicate an error.
<P><STRONG>See Also</STRONG>
<P>
<TT><STRONG>
<A HREF="progu336.htm#HDRDXTBE">DXTube</A>
</STRONG></TT>
<P>
<A HREF="progu074.htm#HDRPHOS">15.3 , "Path Operations"</A>.
<P><HR><B>&#91; <A HREF="#Top_Of_Page">Top of Page</A> &#124; <A
HREF="progu295.htm">Previous Page</A> &#124; <A HREF="progu297.htm">Next
Page</A> &#124; <A HREF="../proguide.htm#ToC">Table of Contents</A> &#124; <A
HREF="progu097.htm#PToC20">Partial Table of Contents</A> &#124; <A
HREF="progu344.htm#HDRINDEX_START">Index</A> &#93;</B> <br><b>&#91;<a
href="../allguide.htm">Data Explorer Documentation</a>&nbsp;&#124;&nbsp;<a
href="../qikguide.htm">QuickStart Guide</a>&nbsp;&#124;&nbsp;<a
href="../usrguide.htm">User&#39;s Guide</a>&nbsp;&#124;&nbsp;<a
href="../refguide.htm">User&#39;s Reference</a>&nbsp;&#124;&nbsp;<a
href="../proguide.htm">Programmer&#39;s Reference</a>&nbsp;&#124;&nbsp;<a
href="../insguide.htm">Installation and Configuration
Guide</a>&nbsp;&#93;</b><br><p><b>&#91;<a
href="http://www.research.ibm.com/dx">Data Explorer Home
Page</a>&#93;</b><p><HR ALIGN=LEFT WIDTH=600><b>&#91;<A
HREF="http://www.ibm.com/">IBM Home Page</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Orders/">Order</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Search/">Search</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Assist/">Contact IBM</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Legal/">Legal</A>&nbsp;&#93;</b><hr><p>
<A NAME="Bot_Of_Page"></A>
</BODY></HTML>
